SoundVQ Locater File Syntax

Introduction

By simply writing the location of the SoundVQ Compression File (or TwinVQ Compression File) to the locater file, it is possible to start the SoundVQ Player as a helper. Follow things are possible by Locater file.

Files with the extension ".vql" or ".vqe" are known as SoundVQ Locater Files. These files are text files (as opposed to files with the extension ".vqf"). If the SoundVQ Player is already installed, just clicking to the right of the locator file will cause the Edit(E) menu to appear.

1.Locater File Syntax

1.1 URL beginning with http:
The end of a one line entry must be .vqf or .vql. The same is true below up to 1.5.
e.g.) To send vqf-file streaming
http://www.yamaha.co.jp/xg/SoundVQ/sample/test1.vqf
e.g.) To play indirectly through another vql
http://www.yamaha.co.jp/xg/SoundVQ/sample/test2.vql

1.2 URL beginning with file-name.
You can chose both "vql" and "vqf" in this way
e.g.)
file:///c:\test\test1.vqf
e.g.)
file:///c|\test\test1.vqf

1.3 Absolute pass starting with driver name.
You can chose both "vql" and "vqf" in this way
e.g.)
c:\test\test1.vqf

1.4 Relative pass (not starting with drive name) suggested for removal media such as CD-ROM and MO.
You can chose both "vql" and "vqf" in this way
e.g.) select vqf file in same directory
test1.vqf
e.g.) select from "data" directory
data\test1.vqf
e.g.) selset from another directory in parent directory
..\music\test1.vqf

1.5 Absolute pass (not starting with drive name) suggested for removal media such as CD-ROM and MO.
select this way instead of 1.4 for "Netscape" (both 1.5 and 1.4 are OK in MS Internet Explorer)
You can chose both "vql" and "vqf" in this way
e.g.) \soundvq\test1.vqf

1.6 URL starting with http: (with extensions other than .vqf and .vql).
The URL is sent to the default Web Browser. The transmitted browser carries out processing of the URL (temporary specifications).

1.7 Comment starting with "# "
the line starting with "# " (# & space) is comment. the line "#" alone is also comment.

1.8 Comment starting with "#preload("
the line starting with "#preload(" describes preload function. See 4.About preload function.

1.9 Restrictions
The function in 1.6 cannot be used to make multiple entries.
GOOD SAMPLE

2. What is the list function?

The entries from 1.1 to 1.5 above make it possible to divide up the Return codes in a single locater file to write several. This method of causing playback in the order of multiple selections is only possible via the locator file.

e.g.
http://www.yamaha.co.jp/SoundVQ/test/01-op.vqf
http://www.yamaha.co.jp/SoundVQ/test/02-kare.vqf
http://www.yamaha.co.jp/SoundVQ/test/03-goodby.vqf

The behavior of the SoundVQ player when a locater file has been opened is as follows.

  1. The display "123" appears at the lowest part of the Player. This indicates that there are still three sections to be played.
  2. Automatic playback starts and there is playing of the 1st, 2nd and 3rd sections in order.
  3. By pressing the Next button or Prev button during playback, it is possible to shift to the next selection or the previous selection.

3.Stream playback via the network.

When carrying out stream playback via the network, it is only possible to use locater files with descriptions as found in 1.1 and 1.6 above or in section 1.9 ('GOOD SAMPLE').

4.About preload function

Sample vql file or vqe file whih uses preload function 

--BEGIN--
#preload(2,3,4,5,6,7)
http://www.xxx.co.jp/SoundVQ/snd/dolphin.vqf
http://www.xxx.co.jp/SoundVQ/snd/pig.vqf
http://www.xxx.co.jp/SoundVQ/snd/owl.vqf
http://www.xxx.co.jp/SoundVQ/snd/mouse.vqf
http://www.xxx.co.jp/SoundVQ/snd/swallow.vqf
http://www.xxx.co.jp/SoundVQ/snd/cricket.vqf
--END--

Explanation

When SoundVQ Player or Plug-in loads above vql (or vqe) file, files of URL which is described at line 2,3,4,5,6,7 are downloaded before above vql (or vqe) file's loading ends. (When preload function is used and preloaded file is large, user must wait long long time patiently.)

The point is that preloaded file do not need streming playback, so when user push play button the sound is played quickly without time to download from network. Preload function is mainly for SoundVQ Plug-in.

Preloaded file is avilable until next SoundVQ file is loaded or the Player or Plug-in ends.

Limitation

about expression in the #preload():

GOOD
#preload(2,4,7,9)

BAD
#preload(3, 4, 5) - must not use space
#preload(3,2,4,5) - numbers must sort 2->3->4->5, good sample for this case is #prelaod(2,3,4,5)
#preload(2,3,3,5) - do not use same number



| BACK | | SoundVQ TOP PAGE |


Copyright(C) 1997 YAMAHA CORPORATION All Rights Reserved.